home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 22 / Cream of the Crop 22.iso / os2 / nvsn.zip / NVSN.DOC < prev    next >
Text File  |  1996-10-20  |  9KB  |  228 lines
  1.  
  2.                             N i g h t   V i s i o n
  3.  
  4.                                   Version 1.0
  5.  
  6.                          Copyright (C) B. Simpson 1996
  7.  
  8.                        OS/2 Shareware  Astronomy Program
  9.  
  10.  
  11.  
  12.   Night Vision is a "planetarium" program for OS/2, and will display the
  13.   heavens from any location on earth.  Viewing options allow the user to
  14.   control which sky objects to display, which font to use, and manipulation
  15.   of various star parameters.  Time may be set to run at multiple speeds,
  16.   including backwards.
  17.  
  18.  
  19.   --- Shareware --------------------------------------------------------------
  20.  
  21.   Night Vision is shareware.  It may be freely copied and distributed provided
  22.   that the program in all of its components (program file, help file, database
  23.   files, install file, and documentation) are kept together and all remain
  24.   unmodified.
  25.  
  26.   Considerable effort has gone into the making of this program.  If you find
  27.   it useful please register by contributing $15 to:
  28.  
  29.     Brian Simpson
  30.     P.O. Box 773
  31.     Niwot, CO.  80544
  32.  
  33.   Comments and suggestions are welcome.
  34.  
  35.  
  36.   --- Disclaimer -------------------------------------------------------------
  37.  
  38.   Night Vision is provided "as is" without warranty of any kind.  No warranty
  39.   is made, expressed, or implied, that this documentation or accompanying
  40.   software is free of error, or is consistent with any particular standard of
  41.   performance, quality, or merchantability, or that it will meet your
  42.   requirements for any particular application.  It should not be relied on for
  43.   solving a problem whose incorrect solution could result in injury to a
  44.   person or loss of property.  If you do use this software in such a manner,
  45.   it is at your own risk.  The author and distributors disclaim all liability
  46.   for direct, incidental, or consequential damages resulting from your use of
  47.   this software.  The use of this program constitutes total agreement and
  48.   acceptance of this disclaimer.
  49.  
  50.  
  51.   --- Requirements -----------------------------------------------------------
  52.  
  53.   Night Vision requires OS/2 version 2.1 or later.  (Untested on 2.0)
  54.  
  55.   Night Vision should run on any X86 - based processor that runs OS/2.
  56.   Because of the computationally intensive nature of this program, a math
  57.   coprocessor is strongly recommended.  (A math coprocessor is already built
  58.   into 486DX, Pentium, and later processors, but is a separate chip on some
  59.   other systems.)
  60.  
  61.  
  62.   --- Installation -----------------------------------------------------------
  63.  
  64.   Since you are reading this documentation, you have likely already unzipped
  65.   NVSN.ZIP into its component files.  Place all files into a directory on your
  66.   hard drive and issue the following command from an OS/2 command prompt in
  67.   that directory:
  68.  
  69.     INSTALL
  70.  
  71.   A program icon will be installed onto your OS/2 desktop.  Just double click
  72.   on the icon to start Night Vision.  Alternately you can invoke the program
  73.   by issuing the following command from the same directory:
  74.  
  75.     NVSN
  76.  
  77.  
  78.   --- Your first view --------------------------------------------------------
  79.  
  80.   Night Vision opens with a view of the heavens looking straight up from the
  81.   user's preferred location.  (Or, until a preferred location has been
  82.   selected, a default location of Niwot, Colorado, the author's favorite small
  83.   town.)
  84.  
  85.   Two scroll bars control the direction of view:
  86.  
  87.     Moving the vertical scroll bar (right side of window) controls the
  88.     altitude, or the angle from the horizon to the center of the view
  89.     (center of window).  With the scroll at the top the view is straight up.
  90.     With the scroll at the bottom the view is along the horizon.  Brown
  91.     tinting will indicate where the earth blocks the view.  (This horizon
  92.     indication can be turned off.)
  93.  
  94.     Moving the horizontal scroll bar (bottom of window) controls the
  95.     azimuth, or direction along the horizon.  With the scroll in the center,
  96.     the view towards the horizon is to the south.  Moving the scroll to the
  97.     right moves the view to the west, then the north.  Moving the scroll to
  98.     the left moves the view to the east, then the north.  Thus north can be
  99.     achieved by moving the scroll either to the far right or the far left.
  100.  
  101.     Altitude and azimuth are indicated in the information window at the top.
  102.     Interpret altitude as follows:
  103.  
  104.       Alt          View
  105.       ---------------------------------
  106.       0            Along the horizon
  107.       90           Straight up (zenith)
  108.  
  109.     Interpret azimuth as follows:
  110.  
  111.       Az           View
  112.       ---------------------------------
  113.       0 and 360    North
  114.       90           East
  115.       180          South
  116.       270          West
  117.  
  118.   Magnification is controlled as follows:
  119.  
  120.     Pressing 'z' will "zoom in" to magnify the view.
  121.  
  122.     Pressing 'Z' will "zoom out" to de-magnify the view.  By pressing 'Z'
  123.     and/or enlarging the window an entire 180° view can be seen.  (I.e. 90°
  124.     in all directions from center of window.)
  125.  
  126.     'CapsLock' must be off for 'z' and 'Z' to work.
  127.  
  128.  
  129.   --- Setup ------------------------------------------------------------------
  130.  
  131.   Night Vision can be set up for any location.  Begin by going to the
  132.   "Location" window (via the "Set" pull down menu).  Select the city closest
  133.   to your location, select/deselect "Daylight savings time", and press "OK
  134.   City".  Or enter your longitude, latitude, and time zone, select/deselect
  135.   "Daylight savings time", and press "OK Coordinates".  If your new location
  136.   is in a different time zone, then your local time (as displayed in the
  137.   information line above the star window) will have changed, and you must
  138.   reset the time.  To do so, go to the "Set local date/time" window (via the
  139.   "Time" pull down menu) and then press "Set to computer date/time".  You are
  140.   now re-sync'd to your computer time.
  141.  
  142.   Be sure to save this location information if you would like Night Vision to
  143.   always start at this position.  Go to the "File" pull down menu and select
  144.   "Save location".
  145.  
  146.   You may also save your viewing preferences (objects, font, and star
  147.   parameters) by selecting "Save preferences" from the "File" pull down menu.
  148.  
  149.   Note:  The city database used in the "Location" window may be edited to suit
  150.   the user's preferences.  Follow the directions at the top of NVSN.CTY.
  151.  
  152.  
  153.   --- List of files ----------------------------------------------------------
  154.  
  155.   Night Vision contains the following files:
  156.  
  157.     File           Description
  158.     -------------------------------------------------------
  159.  
  160.     NVSN.EXE       The executable (program file) for
  161.                    Night Vision
  162.  
  163.     NVSN.HLP       The help file
  164.  
  165.     NVSN.DB        Sky database
  166.  
  167.     NVSN.CTY       City database - May be modified, but
  168.                    please distribute only the original
  169.  
  170.     NVSN.DOC       Documentation - This file
  171.  
  172.     INSTALL.CMD    Installs program object onto desktop
  173.  
  174.     NVSN.INI       Initialization file - Created by program
  175.                    - Should not be distributed with other
  176.                    files
  177.  
  178.  
  179.   --- Misc. notes ------------------------------------------------------------
  180.  
  181.   Night Vision is written in C++ and uses the IBM Open Class Library.  The
  182.   program utilizes two threads of execution.  The first manages the user
  183.   interface, while the second manages drawing on the main window.
  184.  
  185.   The star database is derived from the "Yale Catalogue of Bright Stars", a
  186.   public domain listing of over 9,000 stars.  Their placement is for
  187.   Epoch 2000.0 (i.e. the beginning of the year 2000AD).  No adjustment for
  188.   precession is made, which is the reason for limiting the dates between 1900
  189.   and 2099.
  190.  
  191.  
  192.   --- Bugs -------------------------------------------------------------------
  193.  
  194.   Please report any bugs to the registration address given above.  Comments
  195.   and suggestions also welcome.
  196.  
  197.  
  198.   --- Future updates ---------------------------------------------------------
  199.  
  200.  
  201.   Night Vision will be updated in the future.  Future updates may include:
  202.  
  203.     -  Printing
  204.  
  205.     -  Precession
  206.  
  207.     -  Star identification
  208.  
  209.     -  User selectable colors
  210.  
  211.     -  User selectable fonts per object
  212.  
  213.     -  User modifiable information line
  214.  
  215.     -  Constellation boundaries
  216.  
  217.     -  Altitude/Azimuth grid
  218.  
  219.     -  Labels for grids
  220.  
  221.     -  Comets
  222.  
  223.     -  ...
  224.  
  225.  
  226.   ----------------------------------------------------------------------------
  227.  
  228.